home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / ullog301.zip / ULLOG.DOC next >
Text File  |  1991-01-16  |  8KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                     ┌───────────────────────────────────────┐
  15.                     │            -*- UL-Log -*-             │
  16.                     └───────────────────────────────────────┘
  17.  
  18.                                      v3.01
  19.  
  20.                          An upload logging utility for
  21.                                QuickBBS systems.
  22.  
  23.                                        by
  24.  
  25.                                    Bob Ransom
  26.  
  27.                                Copyright (c) 1991
  28.                               All Rights Reserved
  29.  
  30.  
  31.  
  32.            FIRST THINGS FIRST --
  33.  
  34.            V3.01 is a minor update of ULLOG 3.00.  3.01 was written to
  35.            work correctly with the new log entries used by QuickBBS
  36.            v2.66 - 2.75.  With the new auto-ANSI-detect entry in the
  37.            log, ULLOG 3.00 was screwing up the uploaders name.
  38.  
  39.  
  40.            WHAT IT IS (or WHAT IT BE) --
  41.  
  42.            UL-Log is a QuickBBS utility to help you keep track of who
  43.            uploaded what.  Found a virus or Trojan program?  Check
  44.            your upload log and see who sent it.  Keep finding
  45.            copyrighted games, etc. in your directories?  Again, check
  46.            your upload log and see who sent it.  Considering some of
  47.            the stuff that I get sent, I can't imagine not having a
  48.            way to keep track of everything.
  49.  
  50.  
  51.            WHY USE UL-Log? --
  52.  
  53.            Since many of you run Filedoor, which will keep its own
  54.            upload log if you want it to, you may ask why you would
  55.            need UL-Log?  One simple reason:  UL-Log keeps the most
  56.            recent uploads on the top of the log.  This is no major
  57.            big deal when you first starting tracking your uploads.
  58.            However, after 6 or 7 months your upload log begins
  59.            getting long -- like REAL long, if you're lucky.  And you
  60.            have to look through months of old information just to
  61.  
  62.  
  63.  
  64.          ULLOG v3.01 Docs                                  Page 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.            found out who sent that Infocom game last Saturday.  This
  74.            little feature requires just a tiny change in the code,
  75.            but makes the program MUCH nicer.
  76.  
  77.  
  78.            RUNNING UL-Log --
  79.  
  80.            UL-Log must have the QuickBBS SYSTEM.LOG available to it,
  81.            either by finding it in the current directory or by
  82.            finding it on the path.  If the log is missing, UL-Log
  83.            will abort with an on-screen message and a DOS errorlevel
  84.            of 1.
  85.  
  86.            UL-Log then processes the SYSTEM.LOG and, when finished,
  87.            writes out the files UL.LOG and ULLOG.PTR.  The first file
  88.            (UL.LOG) is the actual upload log, which will contain any
  89.            new uploads plus all of the older uploads in the old
  90.            UL.LOG.  The second file is the "pointer" file that allows
  91.            UL-Log to keep track of how far it has processed on any
  92.            given SYSTEM.LOG.  (Without tracking this in some way,
  93.            UL-Log would count the same upload more than once if it
  94.            processed a log more than once.)
  95.  
  96.  
  97.            THINGS YOU SHOULD KNOW --
  98.  
  99.            The maximum number of uploads contained in any one
  100.            SYSTEM.LOG should not exceed 400.  I can't imagine this
  101.            ever being a problem but, if it is, let me know and I'll
  102.            increase it.
  103.  
  104.            The file sizes of the SYSTEM.LOG and the stored UL.LOG
  105.            don't matter.  UL-Log will happily process away until it
  106.            finds the end of the file.
  107.  
  108.            If your upload path is too long, UL-Log will save only
  109.            part of it -- the important part containing the last two
  110.            or three directories and the file name.  This shouldn't be
  111.            a problem as you'll still be able to figure out where the
  112.            upload went.  And you'll never even SEE this happen unless
  113.            you nest your upload directories 4 or more directories
  114.            deep.
  115.  
  116.            UL-Log expects to find the users name on the line
  117.            immediately following a string of asterisks (*) --or-- in
  118.            the case of auto-ANSI-detection, the line immediately
  119.            following that (2 lines below the asterisks).  QuickBBS
  120.            uses asterisks to separate each users entry into the
  121.            SYSTEM.LOG.  When a user logs on, QuickBBS logs the line
  122.            of asterisks, followed by "Fred Smith online at 2400 baud"
  123.            into the SYSTEM.LOG.  If you're redirecting anything
  124.            (including your own comments, etc.) to the SYSTEM.LOG,
  125.            please be aware of this.  Using a long string of asterisks
  126.            could cause UL-Log to behave strangely.
  127.  
  128.  
  129.  
  130.          ULLOG v3.01 Docs                                  Page 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.            UL-Log should work fine both on systems using two word
  141.            user names and on those using one word names.
  142.  
  143.  
  144.            UPDATING FROM EARLIER VERSIONS --
  145.  
  146.            You shouldn't have any problem updating to version 3.01.
  147.            Just exchange the old .EXE file for the new one.
  148.  
  149.  
  150.            COPYRIGHT --
  151.  
  152.            You may use and copy this program at will provided you
  153.            follow these basic rules:
  154.  
  155.            1- You don't change the program in any way.  This program
  156.            remains under my copyright with all rights reserved.
  157.  
  158.            2- It's distributed along with all its original files,
  159.            including this document, and the .EXE file.
  160.  
  161.            3- You may NOT charge for distribution of this program.
  162.            If I don't make money off this, no one else should either.
  163.            One exception:  Commercial online services which charge
  164.            for access time may distribute this program.  This
  165.            exception is designed so that the program may be
  166.            distributed on the major commercial services.  You may NOT
  167.            distribute it if you charge "by-the-download" or if you
  168.            "sell" "Public Domain" software disks.
  169.  
  170.  
  171.            PRAISE --
  172.  
  173.            Feel free to say nice things. :-)  Often.
  174.  
  175.  
  176.            PROBLEMS --
  177.  
  178.            If you run into any, I'd like to know about them.  Please
  179.            send as much complete information as possible.  Contact me
  180.            on the QuickBBS echo or by netmail (see below).  If you
  181.            just want to tell me that my program sucks, don't waste
  182.            your time.
  183.  
  184.  
  185.            THANKS --
  186.  
  187.            Thanks go to many people who have helped with this program
  188.            since it's original version: Mike Janke for early help
  189.            learning to use Turbo Pascal; Barron Featherston for
  190.            suggestions; Gene Leduc for beta testing the original TP
  191.            version (3.00); Jim Ray & friends for ripping into this
  192.            one.
  193.  
  194.  
  195.  
  196.          ULLOG v3.01 Docs                                  Page 3
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.            Hope you enjoy the program....
  207.  
  208.  
  209.                                              -Bob Ransom
  210.                                               The Creative Connection
  211.                                               Southfield, MI
  212.                                               (313)/559-9039
  213.                                               (1:120/96.0)
  214.  
  215.                                               January 16, 1991
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.          ULLOG v3.01 Docs                                  Page 4
  263.  
  264.  
  265.